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0S-b4 


The b4 Column Operating System Cartridge 


Overview 

The 0S-b4 cartridge is a normal Timex/Sinclair S0t.fi operating system 
modified to provide a complete 04 column environment- 0S-b4 provides the 
following - 

1) b4 columns on screen, this includes... 

a) LISTings 

b) PRINTing 

c) Editing 

S) t.4 columns to your Centronics printern this includes... 

a) LPRINT 

b) LLIST 

c) COPY - Epson compatible only) 

Complete Centronics printer support is built in and it is virtually user 
transparent. With OS-t.4 what you see on the screen (in b4 columns) is what 
you get on your Centronics printer- 

OS-t.4 generates t.4 characters per line on screen by using the T/S EObfl's 
special b4 column video mode- 


Limitations Of The b4 Column Mode 

The b4 column video mode is a powerful hardware option because it doubles 
the amount of textual information that you can display on your screen, 
enabling you to program more professional app1ications ■ As is usual with 
small computers, advanced features require trade-offs with other features- 
This is very true with the TSEObA's advanced video modes- Below I will 
discuss the limitations of the TSEDbfi's b4 column mode- 

The b4 column mode requires the user the use of a monochrome or RGB 
monitor. The visual quality of text on Color TVs or color monitors will 
probably be unacceptable - 

The b4 column video mode does not provide FLASH- As a result the BASIC 
keyword FLASH will not do anything- Alson the editing line cursor will not 
FLASH- 

There is no separately selectable BORDER colori the BORDER is 
automatically set to the current PAPER color- 
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There is no local (temporary) PAPER or INK- In 0S-b4-. all PAPER and INK 
commands have global effect-, that is-, they change the entire screen- LJhen you 
set PAPER-, the INK automatical ly gets set to a compl imentary color and vice 
versa - 


Using The Cartridge 

There's not much to it- Just turn the power to your computer off-, plug the 
0S-b4 cartridge inn and power up the computer- Voila! A b4 column enhanced 
operating system is at your fingertips- Just about everything works the same 
as the normal system, except you have the b4 column format- 

One of the things you will have to learn about is the built-in Centronics 
printer support- 


Centronics Printer Support 

Overview 

0S-E.4 does not support the Timex/Sinclair E04D printer- LPRINT/LLIST/COPY 
output goes to your Centronics printer if you have a Centronics interface 
attached to your computer- Built in to the system is code to support the 
following Centronics interfaces... 

1) Aerco 

E) Tasman-B 

3) Tasman-C 

4) A & J 

5) Oliger 

A single POK will select your interface- If you desire-, you can provide 
your own interface driver in RAN and select it for system use- This allows 
you to drive devices with any protocol (This includes RSE3E-, as well as 
Centronics)- 

Selecting An Interface 

To select one of the five interfaces listed above-, POKE address b55E3 with 
the following values: 


1) 

Aerco 

lb? 

E) 

T asman-B 

135 

3) 

Tasman-C 

1EE 

4) 

A & J 

1A5 

S) 

Oliger 

lb? 
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To select your own interface driver positiona at address 'N' in RAH you 
have to alter the new system variable IFDR_addr to point to your routine- Use 
the following commands to do this... 

< POKE L.55E3 N - INT (N/E5L) > 

< POKE L55E4-, INT (N/E5L) > 

If after selecting your own interface drive you want to reselect a system 
driver use the appropriate POKE from the descriptions plus the following... 

< POKE L.55E4 -i L.3 > 

Sending Control Codes & Graphics Data 

There are two types of data that can be sent to your Centronics printer^ 
Character or Control codes- Each is handled differently within the system- If 
you want to send control codes or graphics date to your printer you must 
first signal the system by altering the new system variable PRDAT_typ 
(printer data type)- 

To select control code output... 

< POKE USSlfinl > 

To re-select character output... 

< POKE USSlflnO > 

In practice you should only select control code output for the brief 
period necessary to actually pass the control codes and then immediately re¬ 
select character output- Below is an example of this method- In this example 
we are sending the control codes for Emphasized Print mode to a Star Micronic 
SG1D 

Example 


ID POKE USSlflnl : REM PRDAT_typ=cntr1 code 
ED LPRINT CHR$ E7=,CHR$ UTi : REM cntrl codes out 
3D POKE L.551AiD : REM PRDAT_typ = character 


Printer Output Width 


Output width to your Centronics printer defaults to fc.4 columns to 
logically match the screeni what you see on the screen is exactly what you 
get on your printer- This fc.4 column output is not centered on the paperi but 
most printers have control codes to set the left margin- Below is an example 
of how you would center the LLIST/LPRINT output for a Star Micronics SG1D- 


Example: 


ID POKE b551A-.li : REM PRDAT_typ = cntr 1 code 
ED LPRINT CHR$ E7 =, "M" =, CHR$ fli : REM cntrl codes out 
3D POKE L.551A i D : REM PRDAT_typ = character 
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Changing Printer Width 


To change printer output widths do the following... 

< POKE 055E5-. width : RANDOMIZE USR 150E3 > 

Note: Maximum width is ESS characters- 

Suppressing System Linefeed/Carriage Return 

The system normally generates a Carriage return and a Linefeed code after 
each 'width' no# of characters-, but we can suppress this by doing the 
following... 

< POKE LSSlD-iD : REM suppress linefeed> 

< POKE t. 5 511□ : REM suppress carriage return > 

If you suppress carriage returns-, you will become responsible for deciding 
when you want a carriage return. You will have to explicitly send this code 
when necessary- You could use the following routine to do this... 

10 POKE 05S1A-.1 

E0 LPRINT CHR$ 13i 

30 POKE 05S1A-.0 

Suppressing the system CR/LF will effect LLIST so you will have to be 
careful to consider this during program development- 

To restore normal CR/LF operation-. POKE fc.551D-.13 & POKE fc.5511-.10- 

Centering COPY Output 

COPY output is normally aligned with the left-hand side of the printer 
paper. OS-t.4 has a built-in facility to allow COPY centering if you should 
desire it- Eight bytes in the extended system variables area are reserved as 
a COPY centering control code table- The control codes necessary to set the 
left-hand margin for printing are different from printer to printer- If you 
can determine the control code sequence for your printer-, you can POKE them 
into the table -. thereby centering all the subsequent COPY output-. Below is 
an example for the Star Micronics SG10 printer- 

10 POKE fc.55EA-.3: REM length of the subsequent cntrl code sequence 

E0 POKE fc.55ET-.E7: REM ESCAPE code 

30 POKE t.5530 -.77: REM set left margin code 

40 POKE fc.5531-.1T: REM left margin at column IT 


Please note that memory address 055EA holds the length of the subsequent 
control code sequence- It is very important to have this correct- 



Important Printer Notes 


• Embedded print commas cause a linefeed. 

• COPY routines reset all printer modes to power up defaults. 

• At the end of LPRINT/LLIST output to your Centronics printer the 
printer's buffer may still have the last bit of LPRINT/LLIST data 
stored but unprinted. Executing < LPRINT > will force the remaining 
buffer to be printed- 

• If you are outputting to your Centronics printer and it does goes 
offline (error-, paper-out. power-off), oppressing BREAK will not 
immediately return you to BASIC. This is because, at BREAK time, the 
print-out routine does special output to clear the printer, and if 
the printer is offline it will wait until you service the printer 
and bring it back online, before terminating- 


0S-b4 Variances 

The 0S-L.4 in most respects is a fully functional equivalent to your normal 
system. The few areas where the 0S-L.4 varies from your normal system will be 
discussed in the following sections- 

Graphics 

Under the 0S-L.4 your screen display is actually 51E pixels wide but you 
cannot access this double horizontal from BASIC. The following graphics 
commands: PLOT. ORAL). CIRCLE, work exactly as they do in the normal system- 
You specify (X.Y) coordinates where X has the range of D-E55 and Y has a 
range of 0-175- The graphics will be drawn exactly as you would expect- 

The graphics command POINT works a bit differently in 0S-L.4 than with your 
normal system- Normally POINT tests the single screen pixel specified and 
returns the value zero if that pixel is off or the value one if that pixel is 
on- Uith the OS-t.4 you use the specification coordinates with the same range 
(X = D-ESS) but two pixels are tested at once and the actual pixels tested 
(in the 51E wide screen) are ((X*E).Y) and (((X*E)+1).Y) ■ The following 
values are returned by the POINT command and reflect the status of the two 
pixels tested... 


□ = Both 

pixels 

off 

> 

ou 

1 = Right 

pixel 

on 

> 

□i 

E = Left 

pixel 

on 

> 

ID 

3 = Both 

pixels 

on 

> 

ii 


Screen Saving 

The normal method of SAVEing screens will not work for L.4 column screens. 
To SAVE a L4 column screen you must SAVE two separate code blocks back-to- 
back as follows... 
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< SAVE "name" CODE lb3A4-,bl44: SAVE "name" CODE 2457b-,bl44 > 


To LOAD your saved screens back into memoryi do the execute commands 
< LOAD "name" CODE 1L3A4: LOAD "name" CODE 2457b > 


Using 0S-b4 with ZEBRA Disk Drives 

0S-b4 is compatible with the ZEBRA disk drive with the following 
exceptions ■ 

1- Uhen you press the reset button on the disk drive interface modulei 
the 0S-b4 will not boot up properly unless you ensure that there is 

a- No disk in drive 'A'n or 

b- You have a 'START' program on the disk in drive 'A' with the 
following as its first line: < OUT S4 4 n 3: RANDOMIZE USR 
3371 >-, or 

c- For the 0S-b4 boot and auto-CAT on reset: < OUT 244i3: 

RANDOMZE USR 337T: CAT * >-, or 

d. For the 0S-b4 to boot and auto-start a program on reset: < OUT 
244 n 3: RANDOMIZE USR 337T: LOAD *"name" >. 

2. Due to a lack of foresight on the TOS programmers' parti the Disk 
MERGE command will not work with 0S-b4 without special POKES 
directly preceding MERGE commands- The following technique should 
allow you to MERGE from disk: < POKE 2b0b4-,n5: POKE 2bDb514 4: POKE 
2bDbbi253: MERGE *"name" >- 
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Extended System Variables 


Number 

Of Bytes 

Address 

Name 

Contents 

2 

U55DU 

- 

Unused locations. 

2 

L.55UB 

Xpos 

Used by COPY routine- 

1 

L.551D 

CR 

Code here is sent out by LPRINT and LLIST 
as carriage return- 

1 

L.5511 

LF 

Same as above but for linefeed- 

2 

fc.5512 

COPY_addr 

Address of the Centronics COPY routine- 
Normally points to RONt butn you can alter 
it to point to your own routine- 

1 

L.5514 

- 

Unused location- 

1 

bSSIS 

Hpos 

Used by COPY routine- 

1 

U551U 

COLM 

Used by COPY routine- 

1 

U5517 

MAXcl 

Highest column in printer buffer with 
character in it- 

1 

t.5516 

PRDAT_typ 

Printer data type: □ = character-. 1 = 
control codes or graphic data. 

1 

tssn 

LINE 

Used by COPY routine- 

1 

U552D 

Ypos 

Used by COPY routine- 

2 

L.5521 

- 

Unused locations- 

2 

U5523 

IFDR_addr 

Interface driver routine address- Normally 
points to RON-, but-, you can alter it to 
point to your own routine- 

1 

U5525 

UDTH 

Printer output width- 

1 

U552U 

- 

Unused location- 

1 

L.5527 

FLAGSnew 

Various control flags. 

A 

t.5526 

COPYtab 

Table of control codes for COPY centering 
tabulation - 




0S-b4 Memory Map 


ID 



